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GETTING STARTED 



To get started with your ICE™-5100 emulator, do the following: 

• Install the ICE-5100 emulator system hardware as directed in the ICES 100 Emulator 
Installation Supplement. 

• Install the ICE-5100 user probe as directed in the ICE-5100/nnn User Probe Supplement. 

• Run the on-line ICE-5 100 emulator tutorial as explained in this supplement. 

The ICE-5100 Emulator Reference Manual has the following structure. 

Chapter 1 presents an overview of the ICE™-5100 emulator software. 

Chapter 2 presents debugging techniques and advanced ICE-5100 emulator fea- 
tures. 

Chapter 3 is an encyclopedia of ICE-5100 emulator commands, keywords, and re- 
lated topics. 

Appendix A describes the state of the ICE-5100 emulator when power is first turned 
on. 

Appendix B contains a list of miscellaneous topics you should be aware of when using 
the ICE-5100 emulator. 

Appendix C describes use of the clips assembly and the hardware specifications on 
the clips assembly. 

Appendix D contains hardware specifications on the power supply and serial cable 
pin-outs. 

Appendix E lists the error messages displayed by the ICE-5100 emulator. 

Appendix F lists ASCII codes and their functions. 

Appendix G lists related reference publications. 

Glossary contains a list of terms used in the manual. 

Index contains an index of terms used in the manual. 

Inside provides service information, 

back cover 
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Other manuals for the ICE-5100 emulator include: 



Installation explains hardware and software installation, including information on 
Supplement confidence tests and how to make connections for interrupt measurements. 

Provides information on ICE-5100 emulator limitations and suggestions for 

use. 



User Probe Explains user probe specific hardware setup. There is a user probe 
Supplement supplement for each user probe. 

Pocket contains a ready-reference to emulator commands, probe specific 

Reference commands, keywords, and registers. There is a pocket reference for each user 
probe. 
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TUTORIAL GUIDE 

To quickly learn how to use the ICE™-5100 emulator commands and features, Intel recom- 
mends that you complete the on-line tutorial before proceeding to debug your own programs. 

This guide supplements the on-line ICE-5100 emulator tutorial and is divided into four 
sections: 

• Invocation — Section T. 1 explains how to invoke the ICE-5 100 emulator tutorial. 

• Organization — Section T.2 explains how the ICE-5100 emulator tutorial is organized and 
how to use the tutorial. It also lists all the tutorial screens. 

• Tutorial index — Section T.3 contains an index of topics discussed in the on-line tutorial. 

• Program listing — Section T.4 contains a list file of the PL/M-5 1 MESSG program used in 
the tutorial. The list file includes a PL/M-5 1 listing and an equivalent ASM-51 listing. 



T.1 Tutorial Invocation 

The ICE-5100 emulator tutorial is easy to access. 

1 . Prepare your host to use the ICE-5 100 emulator tutorial. Refer to the ICE7 M -5100 Installa- 
tion Supplement, order number 167095, for instructions on installing the ICE-5100 emula- 
tor software and tutorial files on your host computer. 

• IBM PC AT and PC XT users must change the directory to the directory containing the 
tutorial files. For example, if your tutorial files are in the directory named TUTDIR: 



Intel Series IV users must assign a logical device to the directory containing the tuto- 
rial files. For example: 



Intel Series III users on a network must assign a logical device to the directory contain- 
ing the tutorial files, and another logical device to the ICE-5100 emulator software. 
For example: 



• Intel Series III stand-alone users must place the tutorial diskette in drive and the ICE- 
5100 emulator diskette in drive 1 of the host computer system. 
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NOTE 



The ICE-5100 emulator must be in stand-alone mode for the tutorial to execute 
(refer to Figure T-l). 

2. Invoke the emulator software. For example, assuming your ICE-5 100 emulator software is 
in a directory named ICEDIR (where nnn is the number of your user probe, e.g. , ICE252): 

IBM hosts: \i(.H>lK MCCnnn <£nter> 

Intel hosts: 



Series III: 
Series IV: 




3. You can activate the tutorial whenever you have the ICE-5100 emulator hit > prompt. 
Enter the following command from the hit > prompt. 

• For IBM PC AT and PC XT hosts,, enter: 




Figure T-l ICE™-5100 Emulator in Stand-alone Mode 
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• For Intel Series III and Series IV hosts, enter: 



hlt>I 

The following message is displayed: 

* WELCOME TO THE ICE-S1DD EMULATOR TUTORIAL * 

* * 
*****^***n*****t* ************************* ************* 

NOTE: This tutorial will RESET the ICE-SIOO emulator. 
Do you wish to continue? (Y or N)<Enter> 

If you do not want your ICE-5100 emulator RESET (which will clear all pre-set condi- 
tions), or you do not wish to continue with the tutorial, enter N. Otherwise, enter Y to 
continue the initialization process. Figure T-2 shows the first tutorial screen. 



ICE-S1DD EMULATOR TUTORIAL (DOS Version 1-0) 
Copyright ITflL Intel Corporation 
Welcome to the ICE-5100 tutorial. This tutorial 
will teach you how to use the ICE-S100 emulator- 
Note the box to the right. This box appears in 
each screen. It provides the name and title of 
the current screen and shows which keys to enter to move to 
screens or to exit from the tutorial. (To jump to a specific 
"SCR*" where * is the number of the screen desired-) 



SCRl: 


WELCOME TO ICE 


N 


= Next screen 


R 


= Rewrite SCRl 


PR 


= Previous screen 


n 


= Go to main menu 


a 


= Suit tutorial 


SCR« 


= Screen desired 



other tutorial 
screeni enter 



The ICE-S10Q emulator prompt < hlt> ) appears at the bottom of the text under 
a horizontal line- Enter commands from this prompt in either uppercase or 
lowercase letters- Use the <Rubout> key ( <-- at the top of the keyboard) to 
correct a command- Press the <Enter> key to execute the command- 



-Enter N <Enter> to continue with the tutorial- 



hlt> 



Figure T-2 Tutorial Introductory Screen: SCRl 
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T.2 Tutorial Organization 



The tutorial is divided into a main path and a set of feature modules (refer to Figure T-3 for an 
overview of tutorial organization) . The main path is divided into two modules. The first main- 
path module (MODI) guides you through defining the debug environment and running a sam- 
ple program that has a bug in it. The second main-path module (MOD2) guides you through 
finding and fixing the program bug. The feature modules elaborate on topics mentioned in the 
main path (refer to Figure T-4). 

Each screen and module has a name (e.g., SCR5, SCRC3, MODC, FMOD). Typing a screen 
name causes that screen to be displayed. Typing a module name sets up any prerequisites 
needed to carry out the steps in that module, and then displays the first screen of the module. 

The ICE-5 100 emulator tutorial screens are created with ICE-5100 emulator commands. When 
you use the tutorial, you are also using ICE-5100 emulator software. As a consequence, when- 
ever the hit > appears, you can enter any ICE-5100 emulator commands you wish. 



SCR2 : I1AIN MENU 



N 
R 

PR 

n 
s 



Next screen 
Rewrite SCR1 
Previous screen 
Go to main menu 
fluit tutorial 



SCR*= Screen desired 



The purpose of this tutorial is to help you learn 
the ICE-5100 emulator command language and to 
demonstrate a debugging session. 

The tutorial is organized into modules- A module 
is a sequence of screens of information and examples. 
There are two groups of modules: MAIN PATH modules 
(debugging skills)-, and FEATURE modules (supple- 
mentary information on main path topics). The following modules are available: 

MODI Main Path: Basic debugging skills 

HOBS Main Path: Advanced debugging skills 

FflOD Features: Information on specific emulator features 

All commands are executed by pressing the <Enter> key after the command name- 
Select noil-, flOta-. or FMOD now- 




Figure T-3 Tutorial Main Menu: SCR2 
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Once you enter the commands recommended on a particular tutorial screen, you need not 
immediately advance to the next screen. Instead, you are encouraged to experiment with com- 
mands to ensure that you understand the concepts presented. 



When you are ready for the next screen, you can call it by typing N followed by < Enter > (or 
< RETURN >). 

If the screen scrolls out of view before you are finished, it can be redisplayed by typing R 
followed by < Enter > (or < RETURN >). 

T.2.1 Copies of Tutorial Screens 

For your convenience, the two ICE-5100 emulator tutorial (DOS version) menu screens are 
shown in the following figures: 

Figure T-3 Tutorial Main Menu; SCR2 
Figure T-4 Menu of Features Modules: FMOD 



The mo 
on ICE 
name s 
displa 

MEMORY 
MODA 
H0DB 

modc 

UTILIT 
MODD 
MODE 
MODF 
MODG 
MODH 

modi 



FHOD : FEATURE NODULES MENU 
dules listed below contain information 
-51DD emulator topics- Entering a module 
ets the prerequisites for that module and 
ys the first screen of the module- 

ACCESS : 
Memory Access 
ASM Commands 
Save Program Memory 



FMOD: 


MENU OF FEATURES 


M 


Go to main menu 


a 


Suit tutorial 


R 


Rewrite FMOD 


RTN = 


Return to main path 


SCR« = 


Screen desired 



Y FUNCTIONS: 
Line Editor 
History Buffer 
Help Screens 
Debug Procedures (PROCs) 
Namescope 

Configuration and Macro Files 



EMULATION AND TRACE: 
MODJ Go Command 
MODK Break Registers 
MODL Tracing Execution 
MODM Stepping 

DEBUG ENVIRONMENT: 
MODN Dir Command 
MODO Literally 
MODP Save Debug Objects 



Select a menu item by entering the name of the module followed by <Enter>. 

Enter RTN <Enter> to return to the main path of the tutorial 

hlt> 



Figure T-4 Tutorial Feature Modules Menu: FMOD 
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The tutorial main menu gives an overview of the organization of the tutorial. To display this 
menu on your screen, enter: 

Some topics are briefly introduced in the main tutorial path and are explained in more detail in 
the feature modules. Figure T-4 shows the menu for the feature modules. To display this menu 
on your screen, enter the following: 



T.2.2 List of All Tutorial Screens 

Tables T-l and T-2 list all of the tutorial screens, as follows: 

Table T-l Main Path Screens 
Table T-2 Feature Module Screens 

Each module is a major division of the tutorial. The modules are entered by typing the name of 
the module (e.g. MOD2, MODG, MODK). 
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Table T-l Main-Path Screens 



Module 


Screen 


Screen 




Name 


Name 


Title 


Topic 




SCR1 


welcome ro iue 


These screens are discussed in Section 




SCR2 


Main Menu 


T.2.1. 




FMOD 


Menu of Features 




MOD1 


SCR3 


Introduction 


. . 

BASIC DEBUGGING SKILLS 




SCR4 


Intro to LOAD 


This module describes mapping memory, 




SCR5 


Memory Mapping 1 


loading a program, listing and accessing 




SCR6 


Memory Mapping 2 


program symbols, setting NAMESCOPE, 




SCR7 


LOAD MESSG 


and executing a program. 




SCR8 


DIR 






SCR9 


Symbol Access 1 






ooHTO 


Symbol Access 2 






oOHl 1 










Symbol Access 3 






bun Id 








oOH 14 


tno or rvnju i 




MOD2 


SCR 15 


Module 2 


ADVANCED DEBUGGING SKILLS 




SCR16 


PROCs 1 


This module describes creating a debug 




SCR17 


PROCs 2 


procedure (PROC), defining break regis- 




SCR18 


Break Registers 


ters (BRKREG), verifying program vari- 




SCR19 


GO USING BRKREG 


ables, displaying and changing program 




SCR20 


Verify Temp 1 


ASM code, tracing program execution, 




SCR21 


Verify Temp 2 


stepping through program execution, 




SCR22 


Showvar 


and saving program patches and debug 




SCR23 


GO USING 


objects. 




SCR24 


ASM 1 






SCR25 


ASM 2 






SCR26 


Verify patch 






SCR27 


Verify Program 






SCR28 


TRACE 






SCR29 


Stepping 






SCR30 


SAVE and PUT 






SCR31 


Setting Environ 






SCR32 


End of Tutorial 
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Table T-2 Feature Module Screens 



Module 
Name 


Screen 
Name 


Screen 
Title 


Topic 


MO DA 


SCRA1 
SCRA2 
SCRA3 
SCRA4 
SCRA5 


Memory Access 1 
Memory Access 2 
Memory Access 3 
Memory Access 4 
Memory Access 5 


MEMORY ACCESS 
This module demonstates the use of 
MTYPE commands to display and modify 
memory. It also describes the BASE 
command. 


MODB 


SCRB1 
SCRB2 
SCRB3 


ASM Commands 1 
ASM Commands 2 
ASM Commands 3 


ASM COMMANDS 
This module demonstrates using the ASM 
command to change program code. 


MODC 


SCRC1 


SAVE Memory 


SAVE PROGRAM MEMORY 
This module demonstrates copying pro- 
gram memory to a directory file. 


MODD 


SCRD1 


Line Editor 


LINE EDITOR 
This module demonstrates how to modify 
command strings. 


MODE 


SCRE1 


History Buffer 


HISTORY BUFFER 
This module demonstrates the use of the 
command history buffer. 


MODF 


SCRF1 
SCRF2 


HELP Screens 1 
HELP Screens 2 


HELP SCREENS 
This module demonstrates the use of the 
HELP screens. 


MODG 


SCRG1 
SCRG2 
SCRG3 
SCRG4 
SCRG5 
SCRG6 
SCRG7 


Debug PROCs 1 
Debug PROCs 2 
Debug PROCs 3 
Debug PROCs 4 
Debug PROCs 5 
Debug PROCs 6 
Debug PROCs 7 


DEBUG PROCEDURES 
This module demonstrates how to create 
various types of debug procedures using 
various compound-command constructs. 


MODH 


SCRH1 
SCRH2 
SCRH3 
SCRH4 
SCRH5 


NAMESCOPE 1 
NAMESCOPE 2 
NAMESCOPE 3 
NAMESCOPE 4 
NAMESCOPE 5 


NAMESCOPE 
This module demonstrates the use of 
NAMESCOPE to reduce the amount of in- 
formation needed to reference user pro- 
gram symbols. 


MODI 


SCRI1 
SCRI2 


Macro Files 1 
Macro Files 2 


CONFIGURATION AND MACRO FILES 
This module demonstrates the use of con- 
figuration and macro files to automatically 
initialize the system. 


MODJ 


SCRJ1 
SCRJ2 
SCRJ3 
SCRJ4 


GO Command 1 
GO Command 2 
GO Command 3 
GO Command 4 


GO COMMAND 
This module demonstrates the use of the 
GO command to begin and control 
emulation. 
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Table T-2 Feature Module Screens (continued) 



Module 
Name 


Screen 
Name 


Screen 
Title 


Topic 


MODK 


SCRK1 
SCRK2 
SCRK3 
SCRK4 
SCRK5 


Break Registers 1 
Break Registers 2 
Break Registers 3 
Break Registers 4 
Break Registers 5 


BREAK REGISTERS 
This module demonstrates the use of break 
registers (BRKREGs) to control program 
execution. 


MODL 


SCRL1 
SCRL2 
SCRL3 
SCRL4 
SCRL5 


Trace 1 
Trace 2 
Trace 3 
Trace 4 
Trace 5 


TRACING EXECUTION 
This module demonstrates the use of the 
trace buffer and trace registers (TRCREGs) 
to monitor program execution. 


MODM 


SCRM1 
SCRM2 
SCRM3 


Stepping 1 
Stepping 2 
Stepping 3 


STEPPING 
This module demonstrates the use of the 
ISTEP and LSTEP commands to step 
through program execution. 


MODN 


SCRN1 
SCRN2 


DIR Command 1 
DIR Command 2 


DIR COMMAND 
This module demonstrates the use of the 
DIR command to display program symbols 
and debug object names. 


MODO 


SCR01 
SCR02 


LITERALLY 1 
LITERALLY 2 


LITERALLY 
This module demonstrates the use of the 
LITERALLY command to abbreviate charac- 
ter strings, commands, and emulator 
keywords, 


MODP 


SCRP1 
SCRP2 
SCRP3 
SCRP4 
SCRP5 


Save Debug 1 
Save Debug 2 
Save Debug 3 
Save Debug 4 
Save Debug 5 


SAVE DEBUG OBJECTS 
This module demonstrates the use of the 
PUT, APPEND, and INCLUDE commands 
to save and retrieve debug objects from a 
directory file. 
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T.3 Tutorial Index 



The following index correlates ICE-5100 emulator tutorial module and screen names with 
tutorial topics and emulator commands. To display any module or screen cited in the index, 
enter the module or screen name followed by <Enter> (or <RETURN>). For example, to 
display the BASE command information in screen SCRA2, enter SCRA2 < Enter > (or 
< RETURN >). 



Subipct 


Module / Screen Name 


% (procedure parameter) 


SCRG6 


$ (program counter) 


SCRL1 


Abbreviated commands 


MODO 


ALL 


SCR28, SCRL1 


Addresses 


MODA 


APPEND 


MODP, MODC 


Assemble code 


SCRB2 


ASM 


MODB, SCR24 


BASE 


SCRA2 


Base suffix 


SCRA2 


BAUD 


SCRI1 


Binary 


SCRA2 


Break execution 


SCR 13 


Break register (BRKREG) 


SCR 17, MODK 


BYTE 


MODA 


CALL 


SCR 18, SCR22 


rl A K 




CI 


SCRG7 


CLEAR 


SCRL1, SCRL3 


CLEAREOL 


SCR02 


CODE 


SCRA5 


Command editing 


MODD 


Compound commands 


MODG 


Configuration file 


SCRI1 


Constructs, command 


MODG 


COUNT 


SCRG4, SCRM2 


<Ctrl> < Break > 


SCR 19 


<Ctrl>E 


SCR29 


< Ctrl > keys 


MODD 


CURY 


SCR16, SCR02 


Debug procedures 


MODG 


Decimal 


SCRA2 


DEFINE 


SCRF2, SCR17, SCR18, MODO 


DIR 


SCR8, MODN 


Disassemble code 


MODB 


DO 


MODG 


Dot operator ( . ) 


SCR12 


DYNASCOPE 


SCRH4 
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Subject 


Module / Screen Name 


EA pin 




Error messages 




Esc key 


SCR8 


Execution, program 


MODJ 


EXIT 


SCR 14, SCR32 










FROM 


SCR27 


Fully qualified reference 


SCR10 


no 




Uu Jr*Ji\ri v civ 




GO FROM 


SCR19, SCRJ2 


GO TIL 


SCRJ2 


GO USING 


SCR 19 


UATT 


Mom 


HELP 


MODF 


Hexadecimal 


SCRA2 


History buffer 


MODE 


IDATA 


MODA 


IF 


SCRG3 


INCLUDE 


SCRP3, SCRP4, SCRP5 


ISTEP 


SCR29, MODM 


jvey worui 




Label, access 


SCR12, MODA 


JLciNO 1 ri 


MUUA 


Line editor 


\tf\T\V\ 
IvIKJlJlJ 


jL>inc numoers 




1 TTPPAJ I Y 


Mono 








i3l^,lvZ7, iViAyJL'iVi 


Macro file 


SCRI2 


Mftr 




\ /4 f> rn a \ t*A / arppec 


MODA 


Memory address spaces 




Menu, syntax 




Menu, tutorial modules 


SCR2, FMOD 


Mtype (memory type) 


MODA 


NAMESCOPE 


MODH 


Nesting 


SCRG2 


NEWEST 


SCRL2 


Number base 


SCRA2 
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Subject 



Module / Screen Name 



OUTSIDE 


SCRJ3 


Patch, program 


SCR24, MODB 


PRINT 


SCR28, MODL 


PROC 


SCR16, MODG 


Procedures, debug 


MODG 


Program counter ($) 


SCRL1 


PUT 


SCR30, SCRP1, SCRK4 


RDATA 


SCRA5 


REMOVE 


SCRG8, SCRK5 


REPEAT 


SCRG5 


RETURN 


SCR17, SCRK2 


SAVE 


SCR30, MODC 


Screen control 


SCR 16 


Set debug environment 


SCR31, MODI 


Symbol 


SCR9, MODA 


Symbol, address of 


SCR12 


Symbol buffer size 


SCRI1 


Syntax menu 




Tab key 


SCR6, SCRN2 


TIL 


SCRJ2 


TO 


SCR24 SCRA1 


TRACE 


SCR28, MODL 


Trace register (TRCREG) 


SCRL3 


UNTIL 




USING 


SCR19 


VtHIaUlC, aUUlCoS \Jl 




Variable, debug 


SCRG3 


Variable, value of 


SCR9, MODA 


WHILE 


SCRG5 


WRITE 


MODD, SCR22 


XDATA 


SCRA5 
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T.4 Tutorial Program Listings 



The sample program (MESSG) used in the tutorial is written in PL/M-5 1 . The program dis- 
plays the following message: 

Intel ICE-S1D0 Emulators are HOT- 

The display is rotated by shifting the leftmost character to the right most location. The rotation 
is triggered by a timer interrupt. 

There are two files on the tutorial disk associated with the MESSG program: 

MESSG compiled, linked, and located absolute code 
MESSG. LST program listings in PL/M-5 1 code and ASM code 

NOTE 

The absolute addresses in the ASM program listing have been modified to match the 
actual program addresses when the program is loaded at location OH. 

The tutorial frequently references the PL/M-5 1 program listing. 

T.4.1 Program Listing for the MESSG Program 

The following PL/M-5 1 listing of the MESSG program contains a bug on line #28 that is found 
and corrected in the tutorial. 

DOS 3-10 (03t,-N) PL/M-51 Vl-2 

COMPILER INVOKED BY: C: DOSLANG PLMSLEXE HESSG-PLM DEBUG SYMBOLS CODE 

/************************************************************************/ 



/* tl 

I* MESSG-PLM (with bug in line #36) */ 

It PL/M-S1 program which rotates a character string in a buffer */ 

/* according to a timer- This program does not contain any */ 

/* target hardware specific procedures. */ 

/* */ 

/* This program is used as the sample program for the ICE-5100 */ 

/* emulator tutorial- */ 

/* */ 



/J***********************************************************************/ 

1 1 MAIN_DISPLAY: DO i 

/********************** VARIABLE DECLARATIONS ********************** / 



5 1 DECLARE forever LITERALLY ' WHILE 1 ' , 

false LITERALLY '0'-, 

true LITERALLY ' NOT false' i 

/*User variables */ 
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reset_low 
reset_high 

disp_buffer (SO) 
buf f_size 
int_f lag 
message (*) 



BYTE CONSTANT (0fl3H), 
BYTE CONSTANT (OEflH), 

BYTE i 
BYTE, 
BIT, 

BYTE CONSTANT 



(' Intel ICE-5100 Emulators are HOT-'), 
i BYTE, 

/* Timer D processor specific locations */ 



tmO_low 
tmO_high 



BYTE at (DflAH) REGISTER , 
BYTE at (DflCH) REGISTER, 



/************** INITIALIZATION PROCEDURE DECLARATION **************/ 
3 2 INIT: PROCEDURE \ /* Procedure to initialize timers */ 

/* Timer related special function registers */ 



4 2 



5 5 



7 
fl 

10 
11 
12 
13 
14 
IS 



DECLARE TMOD 
ETO 
EA 
TRO 

/* Beginning of initialization code */ 



BYTE at (0S1H) REGISTER, 
BIT at (0A1H) REGISTER, 
BIT at (OAFH) REGISTER, 
BIT at (06CH) REGISTERS 



buff_size = LAST(message) , 



3 DO i = TO <buff_size); 

3 disp_buf f er ( i ) = nessage(i)i 

3 END; 



tmO_low 

tmO_high 

TMOD 

ETO 

EA 

TRO 

int_f lag 



reset_low; 

reset high; 

01H; 

1; 

l; 

l; 

false; 



/* Store the maximum index value */ 

/* Fill the display buffer */ 

/* Initialize timer */ 

/* Timer in lb bit timer mode */ 

/* Set timer interrupt enable */ 

/* Set global interrupt enable */ 

/* Set timer run control bit */ 

/* Initialize interrupt flag */ 



It 1 END INIT, 

/************** TIMER INTERRUPT ROUTINE DECLARATION **************/ 
SERVICE : PROCEDURE INTERRUPT 1; 



17 2 

Ifl 2 

11 2 

20 2 



int_flag = true; 
tmO_lou = reset_low; 
tmO_high = reset_high; 



/* Set the interrupt flag */ 
/* reset timer */ 
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51 5 END =, 

/************* PROCEDURE TO PRINT THE CHARACTER BUFFER *************/ 
55 5 CHAR_DISPLAY: PROCEDURES 

/* PROGRAM STUB : DISPLAY CHARACTERS ON TARGET HARDWARE */ 

53 5 ENDS 

/ ************** PROCEDURE TO ROTATE CHARACTER BUFFER **************/ 

54 5 ROTATE: PROCEDURES 

55 5 DECLARE INDEX_PTR BYTE n /* Temporary variables */ 

TEMP BYTES 

/* Begin subroutine processing */ 

5b 5 INDEX—PTR = IS 

57 5 TEMP = disp buffer(D)S 

/* Rotate all the characters */ 
5fl 3 DO WHILE (index_ptr < buff_size)S /* BUG: should be "<=" */ 

51 3 disp_buf fertindex ptr - 1) = disp_buf f er ( index_ptr ) S 

3D 3 INDEX_PTR = INDEX_PTR + IS 

31 3 ENDS 

35 5 disp_buf f er(buf f_size) = TEHPS /* Put first char at end */ 

33 5 PRINT: CALL CHAR_DISPLAYS /* Display the string on the target hardware */ 

34 5 int_flag = falseS /* Reset the interrupt flag */ 

35 5 ENDS 

/******************************************************************/ 
/******************* BEGIN MAIN PROGRAM *******************/ 
/******************************************************************/ 

3b 1 START: CALL INITS /* Initialize timer */ 

37 5 DO foreverS /* Call rotate after the software */ 

/* interrupt sets the flag */ 

3fl 5 IF (int_flag) THEN 

31 5 CALL ROTATES 

40 5 ENDS 

41 1 END HAIN_DISPLAY" n 
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\ PROCEDURE P1AIN_ 
PROCEDURE INIT 



OODE 7SS322 

0011 7SS400 
0014 

0014 ESS4 
001b D3 
001? 1SS3 
DDI") 501b 

001B ES5M 
001D 100015 

0020 13 
0051 FE 
0022 E5S4 
0024 2421 
002b Ffi 
002? AbOb 

0021 7flS4 
002B 7401 
005J> 2b 
002E Fb 
002F S0E3 
0031 

0031 =100013 

0034 E4 

0035 13 
003b FSflA 

0036 100014 
003B E4 
0D3C 13 
003D FSflC 

003F 7SS101 

0042 D2A1 

0044 D2AF 

004b D23C 

0046 C200 



D0?1: 



D0END?2: 
F 



.DISPLAY (START) 

n STATEMENT * 3 
(START) 

i STATEMENT * S 

MOV BUFF_SIZE-,»22H 

STATEMENT * b 

MOV l!*OOH 

MOV A-iI 
SETB C 

SUBB A n BUFF_SIZE 
JNC D0END?2 

\ STATEMENT » 7 

MOV Ail 

MOV DPTR-i*MESSAGE 
MOVC AnSA+DPTR 
MOV Rbi A 
MOV A, I 

ADD Ai*DISP_BUFFER 
MOV RDi A 
MOV 3RD t ARb 

i STATEMENT * 3 

MOV RO,*I 
MOV Ai#01H 
ADD A-.3R0 
MOV 3R0.A 
JNC D0?1 

\ STATEMENT * 1 
MOV DPTRARESET_LOIil 
CLR A 

MOVC At 3A+DPTR 
MOV TMO-LOU^A 

i STATEMENT * 10 
MOV DPTR-ARESET HIGH 
CLR A 

MOVC A-.3A+DPTR 
MOV TMO_HIGHt A 

; STATEMENT * 11 
MOV TM0Di*01H 

; STATEMENT » 12 

SETB ETO 

\ STATEMENT * 13 

SETB EA 

i STATEMENT * 14 

SETB TRO 

i STATEMENT * IS 
CLR INT_FLAG 
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004A 25 



0D4B D3 
004C 1200 

004E 100013 

0051 E4 ' 

0052 13 

0053 F5SA 

0055 100014 
005S E4 
0051 13 
005A F5SC 

OQSC 55 



i STATEMENT * lb 

RET 

i PROCEDURE INIT (END) 

i STATEMENT # 1? 
\ PROCEDURE SERVICE (START) 

; STATEMENT # lfl 

SETB C 
MOV 



INT_FLAGiC 

i STATEMENT # 11 
MOV DPTRt#RESET_LOU 
CLR A 

MOVC A-.3A+DPTR 

nov tmo_loii)-,a 

i STATEMENT * ED 
MOV DPTRi#RESET__HIGH 
CLR A 

MOVC A-,3A+DPTR 
MOV TMO—HIGHi A 

\ STATEMENT # SI 

RET 



i PROCEDURE SERVICE (END) 



005D 52 



i STATEMENT * 25 

\ PROCEDURE CHAR_DISPLAY (START) 

\ STATEMENT * 23 

RET 

•i PROCEDURE CHAR_DISPLAY (END) 



; STATEMENT # 24 
\ PROCEDURE ROTATE (START) 

; STATEMENT « 2b 



005E 


750S01 


F 


MOV 


INDEXJTR^OIH 










i STATEMENT 


OObl 


655101 


F 


MOV 


TEMPiDISP—BUFFER 










\ STATEMENT 


00b4 




WHILE'S: 






D0b4 


ESOfl 


F 


MOV 


AiINDEX_PTR 


OObb 


C3 




CLR 


C 


OObb 


1553 


F 


SUBB 


A 1 BUFF_SIZE 


OObl 


13 




JNC 


WENDfb 










STATEMENT * 


OObB 


E50B 


F 


MOV 


A-,INDEX_PTR 


OObD 


5451 


F 


ADD 


At*DISP_BUFFER 


OObF 


Ffl 




MOV 


RO-.A 


0070 


E50S 


F 


MOV 


A-,INDEX_PTR 


0072 


14 


DEC 


A 




0073 


flbOb 




MOV 


ARbiSRO 


0075 


5451 


F 


ADD 


A-,#DISP_BUFFER 
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□077 Ffl 
007fl AbOb 



DD7A OSOfl 



DD7C 
DD7E 

□ D7E 
DDflO 
O0A5 

□ □A3 

□□as 

OOflS 
00fl7 

□□an 



flDEb 



ESS3 
5451 
Ffl 

AbOl 



USD 
C500 
55 



OOflA 

OOflA 11QE 
□ OflC 

OOflC 300DD5 
ODflF USE 
0011 

0011 flOFI 
0013 



UEND'b: 



110V R0,A 
MOV 3R0 i ARb 

i STATEMENT # 30 

INC INDEX_PTR 

\ STATEMENT # 31 

S JMP UHILEfS 

•■, STATEMENT # 35 
MOV A nBUFF_SIZE 
ADD A 1 *DISP_BUFFER 
MOV RD n A 
MOV 5IRDnTEMP 

; STATEMENT # 33 



RINT: 



ACALL CHAR_DISPLAY 

i STATEMENT # 34 
CLR INT_FLAG 

i STATEMENT # 35 

RET 

i PROCEDURE ROTATE (END) 



•-, STATEMENT # 3b 



ACALL INIT 



•-, STATEMENT * 37 



START: 
F 

WHILE??: 
F 
F 

THEN? 1 ! : 
UEND'fl: 

\ STATEMENT # 41 
i PROCEDURE MAIN DISPLAY (END) 



; STATEMENT * 3fl 
JNB INT_FLAGiTHEN?1 

i STATEMENT # 3=1 

ACALL ROTATE 

n STATEMENT * 40 

SJMP WHILE?? 
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SYMBOLS LISTING 



DEFN SPACE SIZE NAME 



ATTRIBUTES 



2 


DATA 


1 


BUFF SIZE 


. BYTE 


22 


CODE 


1 


CHAR_DISPLAY. 


• PROCEDURE USING(O) ST ACK = 02H 


2 


DATA 


5D 


DISP_BUFFER. . 


• BYTE ARRAY ( 5D ) 


4 






EA 


• BIT REGISTER AT(AFH) 


4 






ETD 


■BIT REGISTER AT ( ATH ) 


2 






FALSE 


•LITERALLY 


2 






FOREVER 


. LITERALLY 


2 


DATA 


1 


I 


• BYTE 


25 


DATA 


1 


INDEX__PTR 


■ BYTE 


3 


CODE 


bl 


INIT 


• PROCEDURE USING(D) STACK=Q2H 


2 


BIT 


1 


INT_FL AG 


■ BIT 








LAST 


. BUILTIN 


1 


CODE 




MAIN_DISPL AY - 


• MODULE 


2 


CODE 


35 


MESSAGE 


■ BYTE ARRAY ( 35 ) 


33 


CODE 




PRINT 


■LABEL 


2 


CODE 


1 


RESET_HIGH. . - 


■ BYTE 


2 


CODE 


1 


RESET_LOW 


■ BYTE 


24 


CODE 


44 


ROTATE 


■ PROCEDURE USING(O) STACK=D2H 


17 


CODE 


18 


SERVICE 


■ PROCEDURE USING(O) STACK=D c tH INTERRUPT(l) 


3b 


COPE 




START 


•LABEL 


25 


DATA 


1 


TEMP 


• BYTE 


2 






TM0_HIGH 


• BYTE REGISTER AT(flCH) 


5 






TI10_LOIil 


■ BYTE REGISTER AT(flAH) 








THOD 


■ BYTE REGISTER AT (61H) 


it 






TRO 


• BIT REGISTER AT(flCH) 


2 






TRUE 


• LITERALLY 



WARNINGS : 

1 IS THE HIGHEST USED INTERRUPT 



MODULE INFORMATION: 



(STATIC+OVERLAYABLE) 



CODE SIZE 
CONSTANT SIZE 
DIRECT VARIABLE SIZE 
INDIRECT VARIABLE SIZE 
BIT SIZE 

BIT-ADDRESSABLE SIZE 
AUXILIARY VARIABLE SIZE 
MAXIMUM STACK SIZE 
REGISTER-BANK(S) USED : 
151 LINES READ 



= DDS5H 
= DD2SH 



133D 
37D 



34H+02H 52D + 2D 



OUH+DUH 
D1H+ODH 
ODH+ODH 

= OOODH 

= DD11H 




DD+ OD 
1D+ DD 
OD+ DD 
□ D 
17D 
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